package com.mapper;

import com.bean.MessageBoard;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface MessageBoardMapper {
    /**
     * 根据留言 ID 获取留言信息
     * @param messageId 留言的唯一标识
     * @return 留言信息对象，如果未找到则返回 null
     */
    MessageBoard getMessageBoardById(Integer messageId);

    /**
     * 分页模糊查询留言信息，可根据留言内容或用户名进行模糊匹配
     * @param keyword 模糊查询关键字，可匹配留言内容或用户名
     * @param offset 分页偏移量
     * @param limit 每页记录数
     * @return 符合条件的留言信息列表
     */
    List<MessageBoard> getMessageBoardsWithKeyword(String keyword, int offset, int limit);

    /**
     * 统计符合模糊查询条件的留言信息数量
     * @param keyword 模糊查询关键字，可匹配留言内容或用户名
     * @return 符合条件的留言信息数量
     */
    int countMessageBoardsWithKeyword(String keyword);

    /**
     * 插入新的留言信息
     * @param messageBoard 留言信息对象
     * @return 插入操作影响的行数，成功插入返回 1，失败返回 0
     */
    int insertMessageBoard(MessageBoard messageBoard);

    /**
     * 根据留言 ID 更新留言信息
     * @param messageBoard 留言信息对象，包含要更新的内容，messageId 用于定位记录
     * @return 更新操作影响的行数，成功更新返回 1，失败返回 0
     */
    int updateMessageBoard(MessageBoard messageBoard);

    /**
     * 根据留言 ID 删除留言信息
     * @param messageId 留言的唯一标识
     * @return 删除操作影响的行数，成功删除返回 1，失败返回 0
     */
    int deleteMessageBoardById(Integer messageId);
}